home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1996 #15 / Monster Media Number 15 (Monster Media)(July 1996).ISO / os2 / pmcstex.zip / PMCSTEX.INF (.txt) < prev    next >
OS/2 Help File  |  1996-06-08  |  31KB  |  685 lines

  1.  
  2. ΓòÉΓòÉΓòÉ 1. 1 Introduction ΓòÉΓòÉΓòÉ
  3.  
  4.  pmCSTeX for EPM is a macro package for the editor EPM (free editor for OS/2). 
  5.  It adds some buttons on the toolbar and CSTeX submenu into EPM's menu, 
  6.  allowing user to access many (em)TeX-related actions. 
  7.  
  8.  The aim of this work was the implementation of a pleasant menu system for 
  9.  OS/2. Editor EPM has been chosen since it provides wonderful programming 
  10.  capabilities, and, what it is the most important for the Czech users, there is 
  11.  a programmable Czech keyboard implemented by Z. Wagner (you can get it 
  12.  anonymously from ftp.icpf.cas.cz). (It should be noted that the keyboard that 
  13.  IBM includes in Warp is nearly unusable for programmers since they prefer a 
  14.  reasonable combination of US and Czech keyboard layouts, not standard Czech 
  15.  typing machine layout.  It is really bad that IBM does not provide 
  16.  configurable keyboard driver or its source code.) 
  17.  
  18.  This package is called pmCSTeX since it is related to the CSTeX distribution 
  19.  and because it was worked out by me (pm).  CSTeX (Czech and Slovak TeX) is 
  20.  being released since 1993 and it is based on the TeX implementation by E. 
  21.  Mattes (the famous emTeX).  In addition to the standard emTeX distribution, 
  22.  there are programs and styles that support typesetting in  Czech and Slovak 
  23.  languages. CSTeX includes an installation program (which is missing in emTeX) 
  24.  and a very pleasant menu system for DOS. However, the pmCSTeX package does not 
  25.  require CSTeX installation; you can use it with any (em)TeX distribution. 
  26.  
  27.  Working on pmCSTeX for EPM, the author was motivated by the following 
  28.  packages: 
  29.  
  30.  o CSTeX MNU for DOS: TeX menu system for DOS, included in CSTeX distribution. 
  31.    Author: Petr Ol╤ç╨░k 
  32.  
  33.  o TeXshell: Turbo Vision TeX developing system (for DOS and DOS window in 
  34.    OS/2). I liked it very much (I like Borland-like environments, on-line help 
  35.    etc.), it is programmable in a wonderful way. However, it's just DOS, it has 
  36.    64KB limit on file sizes, it crashed from time to time (in my OS/2 window), 
  37.    and there is no "Undo" function. Author: Juergen Schlegelmilch 
  38.  
  39.  o EPMTeX: TeX menu system for editor EPM. Good, but it does not fulfilled my 
  40.    high expectations I got accustomed to in TeXshell (e.g. it always appends 
  41.    the Master file at the command line). I accepted its First line syntax 
  42.    (Master:, Format: etc.). Authors: Jon Hacker and Rodney Korte 
  43.  
  44.  o WETeX: actions and icons are defined to tex, preview (and more) of a 
  45.    document. Based on EAs, not Master: notation. I do not use it since I do not 
  46.    use WPS (my computer has not got enough RAM). Author: ZdenΓò¬k Wagner 
  47.  
  48.  o emacs: well, I never used this editor except very simple editing (I prefer 
  49.    vi on unix). However, I was always amazed by its feature "(La)TeX current 
  50.    paragraph"---therefore I implemented it in pmCSTeX for EPM as well. Authors: 
  51.    GNU 
  52.  
  53.  o pmgraf: that's my integrated Turbo Vision environment for 2d and 3d graph 
  54.    plotting (see my WWW page for more details). The build-in editor contains 
  55.    hotkeys for pull-down menus for LaTeX environments and font sizes, and a 
  56.    Greek keyboard. Thus I implemented these features into EPM as well. Author: 
  57.    Petr Mikul╨▒k 
  58.  
  59.  This package is FREEWARE. This package is provided AS IS and the author is NOT 
  60.  RESPONSIBLE FOR ANY PROBLEMS that can arise from the use or misuse of pmCSTeX 
  61.  for EPM.  I'm not EPM programmer, I'm physicist.  Don't blame me if something 
  62.  wrong happend to your .tex files, but send me the bug report. Or even better: 
  63.  send me the solution with the appropriate patch. 
  64.  
  65.  This package was developed and tested on EPM 6.03 and EPM 6.03b. Get the 
  66.  latest version of EPM if you have an older one. 
  67.  
  68.  AUTHOR: 
  69.  
  70.  Petr Mikul╨▒k 
  71.  
  72.  Department of Solid State Physics, Faculty of Science, Masaryk University, 
  73.  Kotlarska 2, 611 37 Brno 
  74.  
  75.  Katedra fyziky pevn╨Æ f╨░ze, p┬ñ╨▒rodovΓò¬deck╨░ fakulta, Masarykova univerzita, 
  76.  Kotl╨░┬ñsk╨░ 2, 611 37 Brno 
  77.  
  78.  e-mail: mikulik@physics.muni.cz 
  79.  
  80.  URL: http://www.sci.muni.cz/~mikulik/ 
  81.  
  82.  pmCSTeX is available on hobbes.nmsu.edu (directory os2/unix/tex), on 
  83.  ftp.leo.org (directory pub/comp/os/os2/emTeX/contrib) and on CTAN mirrors 
  84.  (directory CTAN/systems/os2/pmcstex). Online documentation and the up-to-date 
  85.  bug fix list (if needed) is available on my WWW page. Further, pmCSTeX is 
  86.  included in my os2.zip modul for CSTeX'96 distribution (see my WWW page). 
  87.  
  88.  This is version: 8.6.1996 
  89.  
  90.  Note: The coincidence of the abbreviation of my name and the abbreviation of 
  91.  the Presentation Manager is just accidental.  Unfortunately, IBM does not pay 
  92.  me any royalties.  Thus even this package is free, you are welcome to send me 
  93.  donations :-)  (joking... postcards are welcome, but sending a short e-mail is 
  94.  more easier and rapid) 
  95.  
  96.  
  97. ΓòÉΓòÉΓòÉ 2. 2 Installation ΓòÉΓòÉΓòÉ
  98.  
  99.  I hope you already unzip-ed pmCSTeX.zip in an empty directory. Let us suppose 
  100.  you correctly installed EPM (I use 6.03) to the directory E:\APPS\EPM. Thus 
  101.  make directory E:\APPS\EPM\CSTeX and move all files you unpacked from 
  102.  pmCSTeX.zip into it. If you are not user of CSTeX'96 installation, then rename 
  103.  CSTeX_.ex to CSTeX.ex (that _ means that CSTeX.e has been compiled with 
  104.  CSTEX_CSTEX = 0, see below). 
  105.  
  106.  Edit config.sys and change it like 
  107.  
  108.  Example: 
  109.  
  110.   EPMPATH=...;E:\APPS\EPM\CSTeX;...
  111.  
  112.  and be sure that the environmental variable EMTEXOPT is set up like that 
  113.  
  114.  Example: 
  115.  
  116.   SET EMTEXOPT=/mt65000 /mp65000
  117.  
  118.  (this change with the change of .cmd files has been made on 19.5.1996, see 
  119.  History). 
  120.  
  121.  Then edit E:\APPS\EPM\actions.lst and add these two lines to the top of that 
  122.  file: 
  123.  
  124.  Example: 
  125.  
  126.   CSTeX
  127.   pm4EPM
  128.  
  129.  Now edit E:\APPS\EPM\Profile.erx and add these two lines to the bottom: 
  130.  
  131.  Example: 
  132.  
  133.   'link pm4epm'
  134.   'link CSTeX'
  135.  
  136.  If these two files are not present in your EPM directory, unpack them from 
  137.  pm_erx.zip and consult another documentation what are these files about. 
  138.  
  139.  I'm sure you want the on-line hypertext help about LaTeX2e commands. Thus take 
  140.  l2e_ndx.zip and unpack it in the directory %EMTEXDIR%\BOOK\ENGLISH (like 
  141.  E:\EMTEX\BOOK\ENGLISH). Read ltx_inf.rme how R. Niepraschk created 
  142.  LaTeX2e.INF. Then read !CTINDX (in Czech) or !READNDX (in English) how I have 
  143.  created LaTeX2e.NDX.  Follow the instructions there---you have to modify your 
  144.  config.sys to have 
  145.  
  146.  Example: 
  147.  
  148.   SET BOOKSHELF=..;E:\EMTEX\BOOK\ENGLISH;...
  149.   SET EPMPATH=...;E:\EMTEX\BOOK\ENGLISH;...
  150.   SET HELPNDX=...+LaTeX2e.NDX
  151.  
  152.  Now reboot your computer. When it is done, go to E:\APPS\EPM\CSTeX and type 
  153.  
  154.  Example: 
  155.  
  156.   start epm example.tex inc.tex
  157.  
  158.  A new menu item CSTeX should appear on the menu bar. If not, something was 
  159.  wrong and you should repair it (have a good chance!). Probably you have not 
  160.  checked options in File/Settings/Misc. 
  161.  
  162.  Now check the CSTeX toolbar. Go to File/Settings/Toolbars, use "Import" file 
  163.  E:\APPS\EPM\CSTeX\CSTeX.bar, name it CSTeX toolbar and then "Make current". 
  164.  Admire it. If you are not satisfied, change the toolbar as you wish (but do it 
  165.  next day). 
  166.  
  167.  Please verify that you can run from the command line commands latex 
  168.  (=latex2e), plaintex, latex209 etc. (CSTeX'96 users shoudl have cslatex, 
  169.  csplain, cslatex209 etc.). You should have installed emTeX in such a way, that 
  170.  you have latex.cmd, plain.cmd,... (or latex.cmd = cslatex.cmd, csplain.cmd, 
  171.  cslatex209.cmd,...) in %EMTEXDIR%\bin. So you should be able to recompile the 
  172.  LaTeX document typing in an OS/2 window 
  173.  
  174.  Example: 
  175.  
  176.   latex _any_latex_document_.tex
  177.  
  178.  And you should be able to start the previewer by 
  179.  
  180.  Example: 
  181.  
  182.   start dvipm @dvipm.cnf _any_latex_document_.dvi
  183.  
  184.  (I supposed you copied lj.cnf or p6l.cnf or whatever resolution you want to 
  185.  dvipm.cnf). If the above does not work, configure emTeX properly. You can copy 
  186.  the files from pm_bins.zip to %EMTEXDIR%\bin. In any case, copy cykl*.cmd 
  187.  files from it to that directory. 
  188.  
  189.  Check the last lines of %EMTEXDIR%\bin\maketexp.cmd file if you want that 
  190.  dvips generates fonts automatically (dvipm does that par def). 
  191.  
  192.  If you want to run (La)TeX over you document from the command line (without 
  193.  launching EPM), you can use pmTeXit.cmd _your_file_.tex. You should copy 
  194.  pmTeXit.cmd somewhere on your path. 
  195.  
  196.  You may or may not want the automatic syntax highlighting. 
  197.  
  198.  Now, read Czech.E if you use it or go to Tutorial. Please don't forget to read 
  199.  about the syntax of the keywords on the first line of the Master file. 
  200.  
  201.  
  202. ΓòÉΓòÉΓòÉ 2.1. 2.1 Syntax highlighting ΓòÉΓòÉΓòÉ
  203.  
  204.  There are people that do like syntax highlighting (yes, I do) and those they 
  205.  do not like this colour circus. This section is how to enable this spotted 
  206.  feature. 
  207.  
  208.  In order to apply the colours into files listed on the command line after EPM 
  209.  starts, add this line to the end of your Profile.erx file: 
  210.  
  211.  Example: 
  212.  
  213.   'cstex_highlight_all S'
  214.  
  215.  To let file loaded from within EPM (e.g. via menu) flood by colours, put the 
  216.  following code into your MyCNF.e file 
  217.  
  218.  Example: 
  219.  
  220.   defload
  221.   'a_togl_hilit S'
  222.  
  223.  and recompile it (etpm MyCNF.e). Further, you should have line 
  224.  
  225.  Example: 
  226.  
  227.   'link MyCNF'
  228.  
  229.  in your Profile.erx. Files are highlighted according to their extension listed 
  230.  in sampactn.e file (and loaded from sampactn.ex) together with the file like 
  231.  epmkwds._extension_ used for this nice painting feature. Of course, you should 
  232.  have put the line 
  233.  
  234.  Example: 
  235.  
  236.   'link sampactn'
  237.  
  238.  into your Profile.erx (you can have a look at pm_erx.zip file in pmCSTeX 
  239.  distribution to my Profile.erx). Additionally, since the original sampactn.e 
  240.  includes only .tex and .latex extensions, but not .sty, .cls and .dtx, and 
  241.  there is not support for .log files highlighting, you can use my sampactn.e 
  242.  and sampactn.ex included in the pmCSTeX distribution.  If you want to 
  243.  recompile sampactn.e yourself, you need files english.e, stdconst.e and 
  244.  menuhelp.h from epmmac.zip. 
  245.  
  246.  Finally, I prefer the syntax highlighting as used in Borland products---yellow 
  247.  letters on blue background.  If you set those colours in Settings of EPM, then 
  248.  you find worth to unpack pm_hilit.zip (to directory E:\APPS\EPM) to correct 
  249.  the appropriate highlighting files.  Moreover, syntax highlighting for .log 
  250.  files (created by TeX) are supported by epmkwds.log file.  Please don't forget 
  251.  to backup the original files being overwritten. 
  252.  
  253.  
  254. ΓòÉΓòÉΓòÉ 2.2. 2.2 My config.sys ΓòÉΓòÉΓòÉ
  255.  
  256.  Occasionally problems appear when some global variables in config.sys are 
  257.  missing. Here is my config.sys if you want to have a look: 
  258.  
  259.  Example: 
  260.  
  261.  
  262.   SET PATH=...;e:\apps\epm;E:\OS2\APPS;e:\emtex\bin;...
  263.   SET DPATH=...;e:\apps\epm;E:\OS2\APPS;...
  264.   LIBPATH=...;e:\apps\epm;E:\OS2\APPS\DLL;e:\emtex\dll;...
  265.   SET BOOKSHELF=...;e:\apps\epm;e:\emtex\book\english;...
  266.      rem Someone prefers german instead of english
  267.   SET HELP=...;e:\emtex\help;...
  268.  
  269.   ...
  270.  
  271.   rem ******************** emTeX *********************************
  272.  
  273.   SET EMTEXDRV=E
  274.   SET EMTEXDIR=E:\EMTEX
  275.   SET TEXINPUT=E:\EMTEX\TEXINPUT!
  276.     rem For plain only; *tex*.cmd scripts redefine this
  277.   SET EMTEXOPT=/mt65000 /mp65000
  278.     rem This you MUST have!
  279.   SET DVIDRVINPUT=E:\EMTEX\DOC;E:\EMTEX\DOC\ENGLISH
  280.   SET DVIDRVFONTS=E:\EMTEX\fonts
  281.     rem In this case, I do not use the recommendation by E. Mattes to use \TEXFONTS directory
  282.   SET MFJOBOPT=/3
  283.   SET INDEXSTYLE=E:\EMTEX\texinput\latex2e
  284.     rem sth like path for MakeIndex, .ist files?
  285.   SET DVIPSHEADERS=E:\EMTEX\data\dvips
  286.   SET TEXCONFIG=E:\EMTEX\data\dvips
  287.   SET CSBIBALP=E:\EMTEX\data\csbibtex
  288.  
  289.   SET TEXFORMATDEFAULT=latex
  290.   SET HELPNDX=EPMKWHLP.NDX+EMX.NDX+LaTeX2e.NDX
  291.   SET EPMPATH=e:\apps\epm;e:\apps\epm\cstex;e:\apps\epm\epmmac;e:\apps\epm\epmmac2;
  292.      e:\emtex\book\english;e:\emtex\book\czech;e:\os2\apps
  293.  
  294.  
  295. ΓòÉΓòÉΓòÉ 2.3. 2.3 Spell checking in EPM ΓòÉΓòÉΓòÉ
  296.  
  297.  EPM comes with the US dictionary and synonym file. If you want to proof text 
  298.  written in another language, it's quite easy:  IBM Works from your BonusPak 
  299.  use the same dictionary files.  Thus go to the directory of IBM Works of 
  300.  desired language version and copy diction.@ file to your hard disc. Unpack it 
  301.  by the command unpack diction.@ and copy the dictionary files (US.dic, UK.dic, 
  302.  francais.dic) to the desired location (EPM directory). Then type the 
  303.  dictionary filename into EPM Settings/Paths/Dictionary file and rename the 
  304.  default personal dictionary lexam.adl to something like UK.adl, FR.adl etc. 
  305.  
  306.  
  307. ΓòÉΓòÉΓòÉ 2.4. 2.4 Information for Czech.E users ΓòÉΓòÉΓòÉ
  308.  
  309.  If you use the macro Czech.E that implements Czech keyboard in EPM (by Z. 
  310.  Wagner), you would encounter some collisions with the Greek keyboard. That's 
  311.  why you should replace Czech.E by Czech_PM.E (from Czech_PM.zip file in this 
  312.  package). I have added one global variable that keeps the status of the Czech 
  313.  keyboard (and I have commented out the beeps; you can restore them if you like 
  314.  them). 
  315.  
  316.  Pokud p┬ñijdete na d╨òvod tΓò¬ch koliz╨▒ a oprav╨▒te to, dejte mi pros╨▒m vΓò¬dΓò¬t. 
  317.  
  318.  Now, go to  Tutorial. 
  319.  
  320.  
  321. ΓòÉΓòÉΓòÉ 3. 3 Tutorial ΓòÉΓòÉΓòÉ
  322.  
  323.  Welcome to the tutorial! I suppose you launched EPM in E:\APPS\EPM\CSTeX by 
  324.  
  325.  Example: 
  326.  
  327.   start epm example.tex inc.tex
  328.  
  329.  If there is no CSTeX menu item, reboot the computer. Try Tutorial again. If it 
  330.  is the same, consult Installation. 
  331.  
  332.  Now click on the word description (in example.tex file).  Press Ctrl/H. Help 
  333.  should appear.  If not, l2e_ndx.zip was not unpacked well.  Well, if you press 
  334.  Ctrl/H on \batchmode, you get the warning "Unable to find entry...".  It means 
  335.  this key word is not listed in LaTeX2e.NDX.  Well, it's correct---this is TeX 
  336.  primitive and it is not documented in LaTeX2e.INF. 
  337.  
  338.  You edit example.tex. Choose "CSTeX/(La)TeX document /b". Then latex.cmd will 
  339.  be launched to proceed your file (CSTeX'96 users should have their LaTeX.cmd 
  340.  command script equal to csLaTe  cmd). It finished. There was one mistake. 
  341.  However, tex386 has not stopped due to /b (=batchmode) command line parameter 
  342.  passed into tex386.  So you now press Shift-F12 and the error will be 
  343.  localized.  Press several times F12 to localize and read the .log file in the 
  344.  edit ring.  Go back to example.tex, correct the mistake, and press Shift-F12 
  345.  again.  "No more errors" message should appear.  Then start Previewer. 
  346.  Usually you are re(La)TeXing your document while dvipm is simultaneously on 
  347.  your screen, so you hear beep when tex386 finished. 
  348.  
  349.  In the above procedure tex386 window has been minimized so you could see that 
  350.  only new icon appeared on your desktop for a moment.  On the other hand, if 
  351.  you use the menu item "CSTeX/(La)TeX document", then your document is 
  352.  re(La)TeXed on foreground using interactive mode. 
  353.  
  354.  Now click to any paragraph (block of text) and click on icon [TeXit]. The 
  355.  current paragraph should be recompiled and automatically updated by dvipm 
  356.  (haven't you forget to set "Auto reload" in dvipm?). 
  357.  
  358.  Now play with it yourself. Read the other part of the documentation for more 
  359.  details. For full details, read the source code of pm4EPM.e and CSTeX.e. If 
  360.  there some problems, please correct them and send me the solution. Have fun! 
  361.  
  362.  Please don't forget to read about the syntax of the keywords on the first line 
  363.  of the Master file. 
  364.  
  365.  
  366. ΓòÉΓòÉΓòÉ 4. 4 Usage ΓòÉΓòÉΓòÉ
  367.  
  368.  Please go yourself through all the CSTeX menu options, icons and actions that 
  369.  you can icon-ify.  This manual will probably never be too complete. I have to 
  370.  finish my PhD soon so I do not have much time. 
  371.  
  372.  However, it should not mine, since "ordinary" users will hardly change the 
  373.  code, and the programmers will do it easily. Anyway, you are welcome to have a 
  374.  look at .e files what's really inside. They are readable... 
  375.  
  376.  
  377. ΓòÉΓòÉΓòÉ 4.1. 4.1 Syntax of expansions ΓòÉΓòÉΓòÉ
  378.  
  379.  You edit a file. It is called working file. If its first line contains 
  380.  
  381.  Example: 
  382.  
  383.     %  .......   Master: b.tex   .....
  384.  
  385.  then b.tex is its master file to which all actions like latexing, previewing 
  386.  etc. will be related. If there is no Master: keyword on its first line, this 
  387.  file is both Working and Master. 
  388.  
  389.  The first line of the Master file can contain other keywords which are 
  390.  expanded by pm4EPM.e. CSTeX.e reacts to the following keywords: 
  391.  
  392.  Example: 
  393.  
  394.     % .... Format: cslatex209  .....
  395.  
  396.  This is used to texing the document. .cmd file of the same name as is that of 
  397.  the format is called to compile the document (in the above example, 
  398.  cslatex209.cmd is called).  If no Format: is present, environmental variable 
  399.  LATEXFORMATDEFAULT is searched.  If that is not defined, default format latex 
  400.  is used. 
  401.  
  402.  Example: 
  403.  
  404.     % .... EMTEXOPT: */mp85500*  .....
  405.  
  406.  This keyword is added to the environmental variable EMTEXOPT before 
  407.  _format_.cmd is started. The above option I use for AMS-LaTeX and AMS-fonts. 
  408.  Another example: if you want to get rid of the user interaction even in the 
  409.  CSTeX/(La)TeX document, then replace */mp85500* by */mp85500 /b* or by */b*. 
  410.  See the emTeX documentation for more details (\emtex\doc\(english or 
  411.  german)\tex.doc. 
  412.  
  413.  Example: 
  414.  
  415.     % .... dvips: *-p 3 -l 9 -A*  .....
  416.  
  417.  This keyword enables passing parameters into dvips (in this case, only odd 
  418.  pages between page 3 and 9 are postscripted). Look at dvips documentation (or 
  419.  type dvips at the command prompt) for more details. 
  420.  
  421.  Example: 
  422.  
  423.     % .... ViewOpts: */tr1 +zoom:4 +inverse*  .....
  424.  
  425.  The string between those stars (*) or any pair of same chars is taken as the 
  426.  argument for printer/viewer command line. That means not for "Viewer document" 
  427.  (interactive dvipm), but for "Preview before print" and "Print". Consult 
  428.  \emtex\doc\english\dvidrv.doc for more details about the available switches, 
  429.  or type /?? at the dvi* prompt. 
  430.  
  431.  If you are Editing settings of an icon on the toolbar, there is "Parameters" 
  432.  line related to "Action". This Parameter is expanded as described directly in 
  433.  the pm4EPM.e file. They are not used by CSTeX.e (yet). 
  434.  
  435.  
  436. ΓòÉΓòÉΓòÉ 4.2. 4.2 CSTeX menu items explanation ΓòÉΓòÉΓòÉ
  437.  
  438.  LaTeX document 
  439.  
  440.  Compiles document on foreground: start /c /win /f cmd.exe /c %format.cmd %N 
  441.  Abbreviatin %N expands to the master file and %format to the format of the 
  442.  document. 
  443.  
  444.  LaTeX document /b 
  445.  
  446.  As above, but TeXing is started on the background.  Well, in both cases, you 
  447.  should have used \batchmode TeX command in the beginning of your file to force 
  448.  tex386 go smoothly over errors (you locate errors later using Shift-F12). 
  449.  
  450.  Locate next error 
  451.  
  452.  If .log file is loaded, then search for the next error. If .log file is not 
  453.  loaded, load it to the editor and search for the first error. If it is loaded, 
  454.  refresh it and start from the beginning. 
  455.  
  456.  Technical note: the above works fine for me; I think there is no need to 
  457.  implement in next_error to check the file on the harddisk whether it has 
  458.  changed or not every time when next_error function is invoked by the user. 
  459.  
  460.  PostScript menus 
  461.  
  462.  dvips will be used to convert .dvi -> .ps. Then you can launch either gvpm 
  463.  program (it's GhostView for OS/2; see the OS/2 ftp site in Stuttgart or 
  464.  4allTeX CD-ROM) or use the nice DOS previewer psview (available at 
  465.  ftp.muni.cz:pub/tex/local/postscript/psview.zip). If you print from dvips, 
  466.  then the output goes to prn port. See the the keyword dvips: applicable for 
  467.  the Master's first line in the section Syntax. 
  468.  
  469.  Printing menus 
  470.  
  471.  Menu for printing using dvihplj and 300 dpi was well tested. Others not. If 
  472.  you have other printer not listed explicitly in the menu, then .cmd script 
  473.  will be called with myprt1.cmd or myprt2.cmd. For previewing, myprt1.cnf or 
  474.  myprt2.cnf will be used. You should prepare them yourself, according to 
  475.  \emtex\bin\prt*.cmd and \emtex\data\*.cnf files. 
  476.  
  477.  Editor / Include 
  478.  
  479.  The file whose name is under the cursor is included into the editor.  The 
  480.  routine is implemented such that it looks to the current directory, then to 
  481.  ..\units, then to \emtex\texinput, then to some of the \emx\include 
  482.  directories.  You can easily add your favourite directories to the source code 
  483.  of CSTeX.e and recompile the macros. 
  484.  
  485.  Moreover, not only the file under cursor, but as well as those files with .h, 
  486.  .c, .cpp, .sty, .tex are searched. Try it and see. 
  487.  
  488.  Other TeX programs 
  489.  
  490.  Drawing programs: TeXcad is well-known, Qfig probably less. But there are 
  491.  XFree86 ported to OS/2 (http://set.gmd.de/~veit/os2/xf86os2.html) so I'm 
  492.  really glad that I can use Xfig for OS/2. Since you run XFree86 in a separate 
  493.  full-screen session, there is no item for it. PageDraw for PostScript drawing 
  494.  is a good tool as well, but it runs in Win-OS2 session. 
  495.  
  496.  
  497. ΓòÉΓòÉΓòÉ 4.3. 4.3 Hotkeys in CSTeX ΓòÉΓòÉΓòÉ
  498.  
  499.  These hotkeys are defined: 
  500.  
  501.  Ctrl/3 
  502.  
  503.  It brings menu with LaTeX environments 
  504.  
  505.  Ctrl/4 
  506.  
  507.  It brings menu with AMSLaTeX environments 
  508.  
  509.  Ctrl/5 
  510.  
  511.  It brings menu with LaTeX font sizes 
  512.  
  513.  Alt-G 
  514.  
  515.  Switches the keyboard to the Greek keyboard. After pressing Alt-G and pressing 
  516.  a key, its Greek character (in TeX syntax) will be typeset instead. E.g. Alt-G 
  517.  a produces \alpha. 
  518.  
  519.  Note: if the keyboard is not switched to the keyboard layout you was using 
  520.  before, then change the end of DEFPROC pm_TypeGreek() according to any global 
  521.  flag your personal keyboard provides. 
  522.  
  523.  
  524. ΓòÉΓòÉΓòÉ 4.4. 4.4 Hotkeys in pm_keys ΓòÉΓòÉΓòÉ
  525.  
  526.  There are some hotkeys you may or may not find useful. You can either add 
  527.  'link pm_keys' into Profile.erx, or copy the hotkey definitions into your 
  528.  MyKeys.E file (then recompile it). Currently, I use these definitions: 
  529.  
  530.  Ctrl/Y 
  531.  
  532.  It deletes the current line (as Ctrl/BackSpace does). I'm used to this key 
  533.  sequence from Borland-like editors 
  534.  
  535.  Alt-Z 
  536.  
  537.  It brings a dialog with margin setup. Easier then going to File/Settings... 
  538.  
  539.  Alt-Q 
  540.  
  541.  It produces % \begin{equation}...\end{equation} % environment. 
  542.  
  543.  Ctrl-Q 
  544.  
  545.  If the line under cursor contains only \begin{equation}, it changes it into 
  546.  \begin{eqnarray}. If there is \begin{eqnarray}, it is changed to 
  547.  \begin{align}, and if there is \begin{align}, it transforms back to 
  548.  \begin{equation}. The same thing works under \end{...} lines as well. 
  549.  
  550.  
  551. ΓòÉΓòÉΓòÉ 5. 5 Recompiling the macros ΓòÉΓòÉΓòÉ
  552.  
  553.  Your need stdconst.e from epmmac.zip (see hobbes.nmsu.edu:os2/editors). This 
  554.  file has to be on your EPMPATH. 
  555.  
  556.  The following commands will compile CSTeX EPM macros: 
  557.  
  558.  Example: 
  559.  
  560.   etpm pm4EPM
  561.   etpm CSTeX
  562.  
  563.  You can recompile CSTeX.e into two menu schemes depending on the constant 
  564.  CSTEX_CSTEX: 
  565.  
  566.  CSTEX_CSTEX=1 
  567.  
  568.  This produces CSTeX for EPM that is distributed together with CSTeX'96 
  569.  distribution. It includes support for all our favourite CS features and 
  570.  programs 
  571.  
  572.  CSTEX_CSTEX=0 
  573.  
  574.  This disables compilation of the features specific for CSTeX'96 distribution 
  575.  
  576.  CSTEX_CS2CS=1 
  577.  
  578.  Uses OS/2 program cs2cs.exe for Czech encodings conversion (this program does 
  579.  not come with CSTeX'96 distribution yet, get it from 
  580.  ftp://aip1.fsv.cvut.cz/users/ferdi/cs2cs.zip 
  581.  
  582.  CSTEX_CS2CS=0 
  583.  
  584.  Uses DOS program cstocs.exe for Czech encodings conversion (included in 
  585.  CSTeX'96 distribution, but due to cs2cs.exe it became obsolete now) 
  586.  
  587.  Two options in DEFINIT routine in CSTeX.e 
  588.  
  589.  cstex_true_tex_background=1 is default option that minimizes window of the 
  590.  background TeXing. Set cstex_true_tex_background=0 to get the whole window. 
  591.  cstex_background_beep=0 is default option to avoid beep when background texing 
  592.  has finished (dvipm can do it for you). Set cstex_background_beep=1 if you 
  593.  would prefer this beep. 
  594.  
  595.  You can do the appropriate changes in both files---as you wish. In fact, you 
  596.  should changed the menus and related things if some build-in options do not 
  597.  suite your customs. I tried to write the code as simple as possible---I'm not 
  598.  professional EPM programmer. 
  599.  
  600.  However, KEEP IN MIND that you can distribute the files derived from CSTeX 
  601.  ONLY IF the original distribution of pmCSTeX.zip comes with them! People need 
  602.  to know where that comes from, whom they can make donations to or who is the 
  603.  person to blame... 
  604.  
  605.  
  606. ΓòÉΓòÉΓòÉ 6. 6 Conclusion ΓòÉΓòÉΓòÉ
  607.  
  608.  This is first international release of pmCSTeX for EPM. I works perfectly for 
  609.  me, but that need not be the case for you. Please let me know what causes 
  610.  problems, what should be additionally included etc. Thanks. 
  611.  
  612.  
  613. ΓòÉΓòÉΓòÉ 6.1. 6.1 History ΓòÉΓòÉΓòÉ
  614.  
  615.  8.6.1996  final release---upload to hobbes, leo and CTAN 
  616.  
  617.  7.6.1996 Meaning of Alt-Q changed, added Ctrl-Q hot key; spell-checker 
  618.  discussion 
  619.  
  620.  28.5.1996 TeXing action works even when you ask for it from within .log file; 
  621.  next_error: oval drawing for ...long line with an error works now better 
  622.  
  623.  26.5.1996 Typo/bug from 19.5. corrected; sampactn.e replaced according to new 
  624.  EPM 6.03b 
  625.  
  626.  19.5.1996 EMTEXOPT keyword added (see syntax) so you don't need to change your 
  627.  .cmd files if you use AMS-LaTeX or memory consuming documents.  Therefore 
  628.  EMTEXOPT environmental variable has to be established and it should contain 
  629.  fixed memory parameters (see Installation).  These were previously in .cmd 
  630.  files and they have been changed in this release.  Using this EMTEXOPT trick 
  631.  there is no more need to have \batchmode command in the Master file.  Document 
  632.  being (La)TeXed on background is iconified, but this can be changed (see 
  633.  recompiling). 
  634.  
  635.  16.5.1996 suggestions and minor changes reported by Wolfgang Kronberg 
  636.  (kroni@bite.shnet.org) taken into account. Section about syntax highlighting 
  637.  written. 
  638.  
  639.  15.5.1996 annoying message "I think you re(La)TeXed..." taken away; dvips 
  640.  option into pm4EPM (i.e. new expandable keyword dvips for the Master's first 
  641.  line included) 
  642.  
  643.  9.5.1996  odstranΓò¬no zdvojen╨▒ ~V v menu View a vlnka 
  644.  
  645.  6.5.1996  announcement in comp.os.os2.announce 
  646.  
  647.  6.5.1996  cstocs.exe replaced by cs2cs.exe 
  648.  
  649.  2.5.1996  AMS-LaTeX environments support 
  650.  
  651.  28.4.1996 Only small changes 
  652.  
  653.  1.3.1996  First public announcement 
  654.  
  655.  6.2.1996  Distribution for my colleagues 
  656.  
  657.  30.1.1996 First useable version for myself 
  658.  
  659.  
  660. ΓòÉΓòÉΓòÉ 6.2. 6.2 Known bugs ΓòÉΓòÉΓòÉ
  661.  
  662.  The same problem of the instability of the red oval over the first error found 
  663.  in .log file as in EPMTEX occured. 
  664.  
  665.  Using "Next error", an error is found correctly but the current file (the file 
  666.  with the error) is switched off to .log file. I don't know why, this comes 
  667.  irregularly, is there something wrong what is on the stack of EPM? Because 
  668.  just before the return command the current file is correct. 
  669.  
  670.  pmCSTeX for EPM for CSTEX'96: Spou╤çtΓò¬n╨▒ DOSovsk╤îch program╨ò 
  671.  Vlnka,dvi-out,csbibtex: nev╨▒m, jak je spustit v oknΓò¬ tak, aby na nΓò¬ EPM po╨»kal 
  672.  a╨╖ se vykonaj╨▒, a teprve pak obnovil soubor v editoru. Zat╨▒m to z╨░platuji 
  673.  hl╨░╤çkou (Pros╨▒m relaxujte...), kterou u╨╖ivatel odklepne, kdy╨╖ DOS u╨╖ skon╨»il a 
  674.  jeho okno se zav┬ñelo. Bylo by velice u╨╖ite╨»n╨Æ, kdyby tyhle programy nΓò¬kdo 
  675.  zkompiloval pro OS/2 
  676.  
  677.  Czech.E users: V prvn╨▒m oknΓò¬ ringu funguje ╨»esk╨░ kl╨░vesnice bez probl╨Æm╨ò, 
  678.  ov╤çem v dal╤ç╨▒ch ji nen╨▒ mo╨╖n╨Æ spustit (p┬ñes Alt-[). Mus╨▒ se napsat jak╨Ækoliv 
  679.  ┬ñeck╨Æ p╨▒smeno (nap┬ñ. Alt-G a) a teprve potom d╨░t Alt-[. Nev╨▒te nΓò¬kdo, pro╨» se 
  680.  to chov╨░ takto? 
  681.  
  682.  
  683. ΓòÉΓòÉΓòÉ 6.3. 6.3 To do! ΓòÉΓòÉΓòÉ
  684.  
  685.  Use it every